Installation & Deployment Guide

Prerequisites

Requirement	Details
Java	JDK 21
Maven	3.8+
Docker	For containerized deployment
Database	SAP HANA instance
Identity Provider	SAP XSUAA or Keycloak instance
Config Server	Spring Cloud Config Server
Container Registry	Azure Container Registry

---

Build Steps

# Step 1: Clone the repository
git clone <repo-url> flowable_custom_v2
cd flowable_custom_v2

# Step 2: Build the application
mvn clean package -DskipTests

# Step 3: Verify JAR is created
ls target/flowable-integration-0.0.1-SNAPSHOT.jar

---

Docker Build & Push

# Build Docker image
docker build -t wblnd.azurecr.io/flowable-latest:<tag> .

# Login to Azure Container Registry
docker login wblnd.azurecr.io -u wblnd -p <password>

# Push image
docker push wblnd.azurecr.io/flowable-latest:<tag>

---

Deploy to SAP BTP Cloud Foundry

# Login to Cloud Foundry
cf login -a https://api.cf.eu10-004.hana.ondemand.com -o <org> -s <space>

# Set Docker registry password
export CF_DOCKER_PASSWORD=<acr_password>

# Deploy using manifest
cf push -f manifest.yml --docker-password $CF_DOCKER_PASSWORD

# Verify deployment
cf apps
cf logs flowabe-custom-sbx-dev-latest --recent

---

Deploy to Kubernetes (AKS)

# Step 1: Create image pull secret
kubectl create secret docker-registry acr-secret \
  --docker-server=wblnd.azurecr.io \
  --docker-username=wblnd \
  --docker-password=<password>

# Step 2: Apply deployment + service
kubectl apply -f flowable-latest-dev.yaml

# Step 3: Apply ingress with TLS
kubectl apply -f flowable-latest-dev-ingress.yaml

# Step 4: Verify
kubectl get pods -l app=flowable-latest-dev
kubectl logs -l app=flowable-latest-dev --tail=100

---

CI/CD Pipeline

The standard pipeline (azure-pipelines.yml) performs:

1. Replace tokens
2. Maven build
3. Docker build & push
4. Publish artifacts

---

Post-Deployment Verification

Check	How
App is running	Visit /swagger-ui/index.html
Database connected	Check logs
Auth working	Try API with valid JWT token
ITM connected	Deploy workflow and verify forms